Skip to content

Update introduction.md#953

Open
veraulitinaYa wants to merge 4 commits intoexercism:mainfrom
veraulitinaYa:patch-1
Open

Update introduction.md#953
veraulitinaYa wants to merge 4 commits intoexercism:mainfrom
veraulitinaYa:patch-1

Conversation

@veraulitinaYa
Copy link
Copy Markdown

Hi! I added some details about PHP arrays! When I was working on the Language List exercise, I didn't find any information on the existence of functions that are provided by PHP to work with arrays.
I thought adding some info on that would be helpful.

Added details about how to use functions PHP provides to work with arrays
@mk-mxp
Copy link
Copy Markdown
Contributor

mk-mxp commented Apr 21, 2026

Hello @veraulitinaYa and welcome to the PHP track!

Our concept exercises try to balance giving information and nudging towards exploration of the documentation. Putting all required functions into the introduction is, in my eyes, too directly giving away the information and preventing from "investing the effort to find the right solution".

There is a link to all array functions at the end of the concept itself. And we always have a hints section (in the online editor the "Get help" tab in the right sidebar may be hidden and you need to scroll to the tab).

With all that new information, would you still want to add the paragraph as it is? I would prefer to at least take out the direct mentioning of array_shift() and count() and instead add another link to the PHP array documentation. What do you think?

@veraulitinaYa
Copy link
Copy Markdown
Author

Hello @mk-mxp! Thank you for welcoming me and giving helpful tips!

Your suggestion sounds great, I'll update the pull request and make another commit!

@veraulitinaYa
Copy link
Copy Markdown
Author

Hi @mk-mxp! I updated my merge request. Does this work better?
I feel that it is helpful information, because as someone who has previously studied C# and JS, I was looking for some information that would tell me that there are no things like Array.Length in PHP and there are functions instead. So even general information about functions would have been helpful for me.
However, if you feel that this would prevent students from more active exploration, I will understand if you decide to cancel my change.

Copy link
Copy Markdown
Contributor

@mk-mxp mk-mxp left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After you applied all the changes, duplicate the new section to the array concept itself (including the link definitions):

  • concepts/arrays/introduction.md is the short starter explanation shown to students when they first look at the concept
  • concepts/arrays/about.md is the (usually) longer in-depth explanation shown after students solved the concept exercise

Add the new text to the end of those files. The file you edited is generated from exercises/concept/language-list/.docs/introduction.md.tpl when you run the command configlet generate --update --yes and must match the contents of the sources.

Exercism has a lot of such things to learn, and we suggest asking in the Exercism forum before making PRs to avoid re-working and frustration.

Thanks a lot for your help and for improving Exercism for everybody!


### Performing Actions with Arrays

PHP provides functions you can use to modify arrays and work with items in arrays. The PHP documentation offers detailed information on [array](https://www.php.net/manual/en/language.types.array.php) functions.
Copy link
Copy Markdown
Contributor

@mk-mxp mk-mxp Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Exercism has some rules for Markdown formatting, that require one sentence per line and the separation of URLs from link placement:

Suggested change
PHP provides functions you can use to modify arrays and work with items in arrays. The PHP documentation offers detailed information on [array](https://www.php.net/manual/en/language.types.array.php) functions.
PHP provides functions you can use to modify arrays and work with items in arrays.
The PHP documentation offers detailed information on [array functions][array-functions] and the [array type][array-type].

The link URL is inserted at the end of the file like this:


[array-functions]: https://www.php.net/manual/en/ref.array.php
[array-type]: https://www.php.net/manual/en/language.types.array.php

@mk-mxp mk-mxp added x:action/improve Improve existing functionality/content x:knowledge/elementary Little Exercism knowledge required x:module/concept Work on Concepts x:type/content Work on content (e.g. exercises, concepts) x:size/tiny Tiny amount of work x:rep/tiny Tiny amount of reputation labels Apr 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

x:action/improve Improve existing functionality/content x:knowledge/elementary Little Exercism knowledge required x:module/concept Work on Concepts x:rep/tiny Tiny amount of reputation x:size/tiny Tiny amount of work x:type/content Work on content (e.g. exercises, concepts)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants